Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 10 - Group Objects / Group Objects Reference

Group Objects Routines / Managing Groups

Q3Group_GetPositionObject

You can use the Q3Group_GetPositionObject function to get the object located at a certain position in a group.

TQ3Status Q3Group_GetPositionObject (
TQ3GroupObject group, 
TQ3GroupPosition position, 
TQ3Object *object);

group

A group.

position

A group position.

object

On exit, a reference to a QuickDraw 3D object.

DESCRIPTION

The Q3Group_GetPositionObject function returns, in the object parameter, a reference to the object having the position specified by the position parameter in the group specified by the group parameter. The reference count of the returned object is incremented. If an error occurs when getting the object, Q3Group_GetPositionObject returns NULL.

ERRORS

kQ3ErrorInvalidObject
kQ3Error_InvalidPositionForGroup
kQ3Error_NULLParameter